home *** CD-ROM | disk | FTP | other *** search
/ X User Tools / X User Tools (O'Reilly and Associates)(1994).ISO / sun4c / archive / xcalenda.z / xcalenda / slib / X11 / xcalendar / xcalendar.hlp < prev   
Text File  |  1994-09-27  |  8KB  |  209 lines
  1.  
  2. XCalendar is a simple interactive calendar program with a notebook
  3. capability. It is built on the X Toolkit and the Athena Widgets.
  4. If you are writing your first toolkit application this
  5. program is an example of an extensive use of callbacks
  6. and event handlers. It also takes advantage of application
  7. specific resources and actions.
  8.  
  9. CREDITS:
  10.         Version 3.0
  11.         Authors: Roman J. Budzianowski - MIT Project Athena
  12.                       Copyright 1988 Massachusetts Institute of Technology
  13.              Richard Bingle - Comp. Sci. Dept., Purdue University
  14.                       Copyright 1990 Purdue University
  15.     Contributions: 
  16.         Beth Chaney - Comp. Sci. Dept., Purdue University
  17.  
  18. You can start the program as:  xcalendar [ month [year]]
  19. If month and year are not provided they are assumed
  20. to be current. 
  21.  
  22. INTERACTIONS:
  23.  
  24. Clicking the left mouse button on a day will start a text editor.
  25. You can edit and save a text.  This text will be associated with the
  26. day. You can later on read and edit this text when you open the editor
  27. for the same day. The text is saved in a file in the directory
  28. ~/Calendar. The editor lets you also clear an entry associated with
  29. a particular day.  You can also scroll through days while in the editor
  30. by clicking on the arrows on either side of the date label.  If an already
  31. open day is scrolled to, an appropriate message is displayed and the 
  32. editor is brought up in read only mode.
  33.  
  34. It is also possible to scroll through months in the main window by 
  35. clicking on the arrows on either side of the current month label.
  36.  
  37. You can highlight all entries in a month by invoking
  38. the function ShowEntries. By default this function is
  39. called when the left mouse button is pressed in the
  40. title window (where month and  year are displayed).
  41. Pressing the same button again will unhighlight the entries.
  42.  
  43.  
  44. MISSING FEATURES:
  45.  
  46. To remove all entries in a particular month
  47. you have to use your system's commands. The naming scheme for
  48. the files makes it easy : the command "rm ~/Calendar/xc*sep1988 "
  49. on UNIX(TM) will remove all entries from september 1988.
  50. The facility to do that from the xcalendar should be provided.
  51.  
  52. One can imagine many other useful features. For example
  53. automatic parsing of the current day entry in search for
  54. appointments to trigger alarms (reminders) at the approriate
  55. time. Well, maybe one day...
  56.  
  57. RESOURCES:
  58.  
  59. The resource data base lets you alter the visual appearance
  60. of the program. You can change fonts, border widths, labels, 
  61. and other resources used by widgets. One use of this facility is
  62. to change names of week days and months.
  63.  
  64. Here are the names of widgets you can use to set 
  65. various resources: 
  66.  
  67. XCalendar    - class of the application
  68. xcalendar    - top level pane
  69. controls     - control panel
  70. quitButton   - quit button
  71. helpButton   - help button
  72. date         - date label
  73. calendar     - calendar pane
  74. daynumbers   - day numbers frame
  75. 1-49         - day number buttons
  76. daynames     - day names frame
  77. MON,TUE,WED,THU,FRI,SAT,SUN - day name buttons
  78. helpWindow   - help window
  79. bcontrols    - month buttons frame
  80. prev         - previous month button
  81. succ         - succeeding month button
  82. cdate        - current date widget
  83. dayEditor    - editor popup
  84. editorFrame  - editor frame
  85. editorTitle  - editor title
  86. editor       - editor
  87. daybuttons   - day buttons frame
  88. prevday      - previous day button
  89. succday      - succeeding day button
  90. editorControls- control panel
  91. doneButton   - done button
  92. saveButton   - save button
  93. clearEntry   - clear entry button
  94.  
  95. Application specific resources:
  96. reverseVideoMark - if True entries are highlighted in reverse video
  97.                    default True for black and white, and False for color
  98.                    displays
  99. setMarkBackground - if True and reverseVideoMark is False entries are
  100.                     highlighted by setting background to markBackground
  101. markBackground    - background color for highlighting entries
  102. setMarkForeground - analogous to setMarkBackground
  103. markForeground    - foreground color for highlighting entries
  104.  
  105. setMarkBackground and setMarkForeground can take any combination of
  106. values.
  107.  
  108. january,february,..,december - these resources can be used for
  109.                     changing names of months.
  110. firstDay - an integer between 1-7,  indicating the day to start a week with,
  111.            default:  7 (Sunday);
  112. markOnStartup   -  if True mark the entries upon startup, 
  113.            default: False;
  114. helpFile        -  full pathname of the xcalendar.hlp file,
  115.            default: /usr/lib/X11/xcalendar.hlp;
  116. textBufferSize  -  maximum size of the text buffer in the day editor,
  117.            default: 2048;
  118.  
  119. DEFAULT RESOURCE DATA BASE:
  120.  
  121. !
  122. XCalendar*showGrip:        False
  123. XCalendar*calendar*internalBorderWidth: 0
  124. XCalendar*input:        True
  125. XCalendar*resize: False
  126. XCalendar*resizable: True
  127. XCalendar.title: XCalendar v.3.0
  128. XCalendar.dayEditor.title: Day Editor
  129. XCalendar.helpWindow.title: XCalendar Help
  130. XCalendar*Font: 8x13
  131.  
  132. XCalendar*helpFile:    ///////////////////////////////////////////////////////////////////////////usr/STAGE/slib/X11/xcalendar/xcalendar.hlp
  133.  
  134. XCalendar*firstDay:        7
  135.  
  136. !bitmaps
  137. XCalendar*prev*bitmap: ///////////////////////////////////////////////////////////////////////////usr/STAGE/slib/X11/xcalendar/larrow.xbm
  138. XCalendar*succ*bitmap: ///////////////////////////////////////////////////////////////////////////usr/STAGE/slib/X11/xcalendar/rarrow.xbm
  139. XCalendar*prevday*bitmap: ///////////////////////////////////////////////////////////////////////////usr/STAGE/slib/X11/xcalendar/larrow.xbm
  140. XCalendar*succday*bitmap: ///////////////////////////////////////////////////////////////////////////usr/STAGE/slib/X11/xcalendar/rarrow.xbm
  141. XCalendar*helpButton*bitmap: ///////////////////////////////////////////////////////////////////////////usr/STAGE/slib/X11/xcalendar/qmark.xbm
  142. XCalendar*quitButton*bitmap: ///////////////////////////////////////////////////////////////////////////usr/STAGE/slib/X11/xcalendar/quit.xbm
  143.  
  144. ! colors
  145. ! Note: These may cause problems using the -rv option on monochrome displays
  146. XCalendar*Background: lightgray
  147. XCalendar*markBackground: Steel Blue
  148. XCalendar*daynames*Background: lightgray
  149. XCalendar*daynames.SUN*Foreground: Red
  150. XCalendar*daynames.SAT*Foreground: Black
  151. XCalendar*daynumbers*Foreground:   Black
  152. XCalendar*daynumbers.1*Foreground: Red
  153. XCalendar*daynumbers.8*Foreground: Red
  154. XCalendar*daynumbers.15*Foreground: Red
  155. XCalendar*daynumbers.22*Foreground: Red
  156. XCalendar*daynumbers.29*Foreground: Red
  157. XCalendar*daynumbers.36*Foreground: Red
  158. XCalendar*helpButton*Background: slategray
  159. XCalendar*helpButton*Foreground: White
  160. XCalendar*quitButton*Background: slategray
  161. XCalendar*quitButton*Foreground: White
  162. XCalendar*editorTitle*Background: lightgray
  163. XCalendar*editorTitle*Foreground: Black
  164. XCalendar*editorControls*Background: lightgray
  165. XCalendar*editorControls*Command.Background: slategray
  166. XCalendar*editorControls*Command.Foreground: White
  167.  
  168. XCalendar*setMarkBackground: True
  169. XCalendar*markOnStartup: True
  170.  
  171. XCalendar.BorderWidth:        2
  172. XCalendar*calendar.borderWidth:    1
  173. XCalendar*borderWidth: 0
  174. XCalendar*date*borderWidth: 0
  175. XCalendar*date*vertDistance: 5
  176.  
  177. XCalendar*date*font:        8x13bold
  178. XCalendar*daynames*font:        8x13bold
  179. XCalendar*dayEditor*editorTitle*font: 8x13bold
  180. XCalendar*helpWindow*editorTitle*font: 8x13bold
  181.  
  182. XCalendar*helpButton*vertDistance: 12
  183. XCalendar*quitButton*vertDistance: 12
  184. XCalendar*editorTitle*vertDistance: 5
  185.  
  186. XCalendar*editorControls*doneButton*label: Done
  187. XCalendar*editorControls*saveButton*label: Save
  188. XCalendar*editorControls*clearEntry*label: Clear Entry
  189.  
  190. XCalendar*dayEditor*geometry: 300x150
  191. XCalendar*helpWindow*geometry: 600x350
  192.  
  193. XCalendar*doneButton*Label: done
  194. XCalendar*editorTitle*Label: Help
  195. XCalendar*helpButton*Label: help
  196. XCalendar*quitButton*Label: quit
  197. XCalendar*saveButton*Label: save
  198.  
  199. XCalendar*bcontrols*borderWidth: 0
  200. XCalendar*prev*highlightThickness: 0
  201. XCalendar*succ*highlightThickness: 0
  202.  
  203. XCalendar*prevday*highlightThickness: 0
  204. XCalendar*succday*highlightThickness: 0
  205. XCalendar*daybuttons*borderWidth: 0
  206.  
  207. XCalendar*Scrollbar.borderWidth: 1
  208. XCalendar*editor.scrollVertical: whenNeeded
  209.